home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr48 / arc11.zip / ARCADE.DOC next >
Text File  |  1995-02-22  |  6KB  |  428 lines
  1. ARCADE v2.00e
  2.  
  3. by Kyle J. Davis
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81. DISCLAIMER
  82.  
  83. ARCADE IS PROVIDED AS IS WITH NO FORM OF WARRANTY AND IS NOT
  84. RESPONSIBLE FOR ANY LOST DATA OR MONEY IN REATION TO IT. 
  85.  
  86. IBM AT is owned by IBM corporation
  87.  
  88. INTRODUCTION
  89.  
  90.     Arcade (formally Dez-X) is a programming language written for
  91. the IBM AT and compatibles. It is an inturpitive language that
  92. can *not* compile to an EXE. It relies on DBF files that contain
  93. program information. This language is a little hard to
  94. understand at first, it is different form most other programming
  95. languages (PLS) because it dose not rely on any sort of known
  96. syntax, for instance in Pascal your would write WRITELN('HELLO
  97. WORLD'); in a source file or in basic you would write 10 Print
  98. "hello world"  but in arcade you would go to a dbf file that
  99. contains the template and enter 001 for the command and for
  100. string_1 you would put Hello World and in X1 you would put your
  101. X coordinates in and in Y1 your Y cordnates in ( it this
  102. document it will be written like this 
  103.  
  104. C: command
  105.  
  106. S1: string_1
  107.  
  108. S2: string_2
  109.  
  110. X1: X1
  111.  
  112. Y1: Y1
  113.  
  114. X2: X2
  115.  
  116. Y2: Y2
  117.  
  118. BR: BYTE RANGE
  119.  
  120. ).
  121.  
  122. ____ Chapter 1: My first program
  123.  
  124.     In Arcade getting started is the hardest part of learning it.
  125. Now we are going to write a program that will clear the screen,
  126. ask for your name, store your name, ask for your age, store it
  127. and then put a message box that  tells your age and name. 
  128.  
  129. LISTING 1-1 - DEMO11.DBF on disk
  130.  
  131. C: 006
  132.  
  133. S1: 
  134.  
  135. S2: 
  136.  
  137. X1: 000
  138.  
  139. Y1: 000
  140.  
  141. X2: 000
  142.  
  143. Y2: 000
  144.  
  145. BR: 000
  146.  
  147.     As you can see I have put 0 (the number) in front of all the
  148. numbers, you must do this for  Arcade to understand it.  I have
  149. also put 000 in all the blanks, this is not required but is
  150. helpful. 
  151.  
  152. C:001
  153.  
  154. S1: Please enter your name:
  155.  
  156. S2:
  157.  
  158. X1: 010
  159.  
  160. Y1: 010
  161.  
  162. X2: 000
  163.  
  164. Y2: 000
  165.  
  166. BR: 000
  167.  
  168.     Command 001 is arcades writing procedure, S1 stores the string
  169. to be displayed and X1 and Y1 are just for the coordinates.
  170.  
  171. C: 002
  172.  
  173. S1:
  174.  
  175. S2:
  176.  
  177. X1:020
  178.  
  179. Y1: 020
  180.  
  181. X2: 000
  182.  
  183. Y2: 000
  184.  
  185. BR:000
  186.  
  187.     Command 002 is the command for read from the keyboard,  again
  188. X1 and Y1 store the coordinates.
  189.  
  190. C:015
  191.  
  192. S1:
  193.  
  194. S2:
  195.  
  196. X1:002
  197.  
  198. Y1:000
  199.  
  200. X2:000
  201.  
  202. Y2:000
  203.  
  204. BR:000
  205.  
  206.     Command 015 will push the one internal variable to the Dynamic
  207. Stack Array (DSA) which is where all of the variables except one
  208. will be stored. Basically it will take the stuff that you read
  209. from the keyboard and will put in to segment 002(X1) of the DSA.
  210.  
  211. C:001
  212.  
  213. S1: Please enter your age:
  214.  
  215. S2:
  216.  
  217. X1:030
  218.  
  219. Y1:030
  220.  
  221. X2:000
  222.  
  223. Y2:000
  224.  
  225. BR:000
  226.  
  227. -------------
  228.  
  229. C: 002
  230.  
  231. S1:
  232.  
  233. S2:
  234.  
  235. X1:040
  236.  
  237. Y1:040
  238.  
  239. X2:000
  240.  
  241. Y2:000
  242.  
  243. BR:000
  244.  
  245. ---------------------
  246.  
  247. C:009
  248.  
  249. S1: You Are:
  250.  
  251. S2:
  252.  
  253. X1:100
  254.  
  255. Y1:100
  256.  
  257. X2:250
  258.  
  259. Y2: 250
  260.  
  261. BR:000
  262.  
  263.     Command 009 will produce a window with a header (S1) in a shape
  264. like this:
  265.  
  266.         X1                                       Y1
  267.  
  268.         ======================
  269.  
  270.                         |                |
  271.  
  272.         |                |
  273.  
  274.         ======================    
  275.  
  276.         X2                      Y2
  277.  
  278.  
  279.  
  280. C: 003
  281.  
  282. S1: 
  283.  
  284. S2:
  285.  
  286. X1: 001
  287.  
  288. Y1: 001
  289.  
  290. X2: 000
  291.  
  292. Y2: 000
  293.  
  294. BR: 000
  295.  
  296.     Command 003 basically dumps the contents of the internal
  297. variable and then places at X1 and Y1.
  298.  
  299. C: 016
  300.  
  301. S1:
  302.  
  303. S2:
  304.  
  305. X1: 002
  306.  
  307. Y1: 000
  308.  
  309. X2: 000
  310.  
  311. Y2: 000
  312.  
  313. BR: 000
  314.  
  315.     Command 16 is command 15's counterpart, it takes the string 1
  316. from segment 1 of the DSA and places it in to the internal
  317. variable.
  318.  
  319. C:003
  320.  
  321. S1:
  322.  
  323. S2:
  324.  
  325. X1:010
  326.  
  327. Y1: 010
  328.  
  329. X2: 000
  330.  
  331. Y2: 000
  332.  
  333. BR: 000
  334.  
  335.  
  336.  
  337.     That's a very basic program in Arcade.
  338.  
  339. ___ Chapter 2: Reference
  340.  
  341.     Commands:
  342.  
  343. 001: Places text on the screen; uses S1, X1,Y1
  344.  
  345. 002: Reads text from the screen; uses S1, X1,Y1
  346.  
  347. 003: Dumps the contents of  internal variable to the screen at
  348. X1, and Y1; uses X1, Y2
  349.  
  350. 004: Sets the color of the foreground; uses BR
  351.  
  352. 005: Sets the color of the Background; uses BR
  353.  
  354. 006: Clears the Screen or window; uses none
  355.  
  356. 007: puts a Clip Sprite on the screen; uses S1, X1, Y1
  357.  
  358. 008: Displays the Program Done message
  359.  
  360. 009: Creates a window; uses S1 (name), X1,Y1,X2,Y2
  361.  
  362. 010: Removes the window handle
  363.  
  364. 011: Draws A line; uses X1,Y1,X2,Y2
  365.  
  366. 012: Draws a Rectangle; uses X1,Y1,X2,Y2
  367.  
  368. 013: Inputs with a prompt; uses X1,Y1, S1
  369.  
  370. 014: Creates A child process, runs another Arcade Program; uses
  371. S1
  372.  
  373. 015: Pushes the internal variable to the DSA at segment X1; uses
  374. X1
  375.  
  376. 016: Pulls the DSA at segment X1 to the internal variable; uses
  377. X1
  378.  
  379. 017: Compares DSA string value at segment X1 to S1, if they
  380. match it runs the file in S2; uses S1,S2,X1
  381.  
  382. 018: Compares DSA numeric value at segment Y1 to X1, if match
  383. occurs it runs the file in S1 uses X1,Y1,S1
  384.  
  385. 019: Defines a numeric variable on the DSA at segment Y1; uses
  386. X1,Y1  
  387.  
  388. 020: Defines a string variable on the DSA at segment X1; uses
  389. X1,S1
  390.  
  391. ___ Chapter 6
  392.  
  393. If you wish to distribute or sell your program you should
  394. register the program an receive the run-time module that
  395. contains to notices. 
  396.  
  397.  
  398.  
  399.     Price        Name             Disc.
  400.  
  401.     $15.00     Arcade RT        Distribute, free updates, more examples
  402.  
  403.     $25.00     Arcade GRT        Includes special game functions such as 256
  404. color                             graphics, ect, ect. Includes every thing above
  405.  
  406.     $45.00        Arcade+        Limited windows use, game pack, all above
  407.  
  408.     $325.00     Arcade NX2        The ultimate arcade interpreter includes
  409. all above and                         many utilities that help you program, such
  410. as a flow                             chart program, a RAD ect. ect.
  411.  
  412. Send orders to 
  413.  
  414.     Kyle Davis
  415.  
  416.     106 Forest Lane
  417.  
  418.     Madisonville Ky 42431
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.